revision

Ingeniería del Software y Práctica Profesional - Universidad de Sevilla#

BERMEJO SORIA, CARLOS

CASAL FERRERO, RUBÉN

DOMÍNGUEZ RUIZ. ANDRÉS

DOMÍNGUEZ-ADAME RUIZ. ALBERTO

FERNÁNDEZ CASTILLO, JAVIER

GALLARDO MARTOS, DANIEL

HERRERA RAMIREZ, ISMAEL

IZQUIERDO LAVADO, MARIO

MATEOS GÓMEZ, FERNANDO JOSÉ

MERINO PALMA, ALEJANDRO JOSÉ

MONTERO MARTÍNEZ, FRANCISCO JESÚS

LÓPEZ MOYANO, ROCÍO

OTERO BARBASÁN, MANUEL

VILAPLANA DE TRÍAS, FRANCISCO DAVID

ZARZUELA REINA, CARLOS

Sevilla, Mayo 2024

Entregable: WPL#

Grupo 01 (Mañana) - IT Talent#

Reviewers Guide

Control de Versiones#

Versión	Fecha	Autor	Cambios
v1.0	04/03/2024	Carlos Bermejo Soria	Documento inicial
v2.0	26/03/2024	Carlos Bermejo Soria	Segundo Sprint
v3.0	20/04/2024	Carlos Bermejo Soria	Tercer Sprint
v3.1	04/05/2024	Carlos Bermejo Soria	PPL
v3.2	18/05/2024	Carlos Bermejo Soria	WPL

Resumen del documento#

Este documento pretende servir de guía para la revisión de la primera demo de IT Talent. Se incluyen tanto el manual de usuario de cada uno de los roles como los requisitos específicos de la guía de revisión.

Índice

Control de Versiones 2**

Resumen del documento 2

Índice 3

1. Datos necesarios 5

1.1 Enlaces y credenciales 5

1.2 Changelog 5

2. Manual de Usuario de candidato 6

2.1 Registro 6

2.2 Inicio de sesión 7

2.3 Cierre de sesión 9

2.4 Perfil 10

2.5 Editar perfil 10

2.6 Developer Info 12

2.7 Mi análisis 12

2.8 Work Experience 13

2.9 Añadir experiencia laboral 13

2.10 Gestionar experiencia laboral 14

2.11 Notificaciones 15

2.12 Perfil del representante 16

2.13 Gestionar notificaciones 17

2.14 Suscripción 17

2.15 Planes del usuario candidato 17

2.16 Selección de plan 18

2.17 Tendencias 19

2.18 Estadísticas 19

2.19 Información 20

3. Manual de Usuario de representantes 21

3.1 Registro 21

3.2 Inicio de sesión 23

3.3 Cierre de sesión 25

3.4 Perfil 25

3.5 Editar perfil 26

3.6 Últimas acciones 27

3.7 Análisis 28

3.8 Análisis 28

3.9 Historial de análisis 30

3.10 Búsqueda 31

3.11 Realizar una búsqueda 31

3.12 Historial de búsquedas 33

3.13 Suscripción 34

3.14 Planes del usuario representante 34

3.15 Selección de plan 35

3.16 Información 36

1. Datos necesarios

1.1 Enlaces y credenciales#

Antes de comenzar a probar la aplicación, es posible que necesite los siguientes enlaces:

URL de la landing page: https://ismaelherrera2000.github.io/it-talent/
URL de la plataforma de despliegue: https://ispp-g1-talent-frontend.vercel.app/
URL de GitHub: https://github.com/JaviFdez7/ISPP-G1-Talent
URL de la herramienta de seguimiento: https://dashboard.bluejay.governify.io/dashboard/script/dashboardLoader.js?dashboardURL=https:%2F%2Freporter.bluejay.governify.io%2Fapi%2Fv4%2Fdashboards%2Ftpa-ISPP-2024-GH-JaviFdez7_ISPP-G1-Talent%2Fmain&orgId=1
URL de Clockify(Monitorización del tiempo) durante el WLP: https://app.clockify.me/shared/664a20211a83b43f357064fe
URL de Clockify(Monitorización del tiempo) durante todo el proyecto: https://app.clockify.me/shared/662f6eaffae1af0dd272ade7
URL de la base de conocimiento del grupo: https://it-talent-wiki.vercel.app/docs/intro
URL de el vídeo de la DEMO: https://youtu.be/ah3kY45EoWI?si=ezsvZngnmuw1knNS
URL de la presentación final: https://www.canva.com/design/DAGErf6bQ3Y/6ZPeML4VGT4VoPQ2jQUMuw/view?utm_content=DAGErf6bQ3Y&utm_campaign=designshare&utm_medium=link&utm_source=editor
URL del LinkTree con nuestras redes sociales: https://linktr.ee/it_talent_oficial

Además, es posible que necesite estas credenciales:

Credenciales herramientas de seguimiento:
- Usuario: user
- Contraseña: bluejay
Credenciales para usuario candidato de IT Talent:
- Usuario 1: TalentCandidate, candidate1234
- Usuario 2: ismaherra, isma1234
Credenciales para usuario representante de IT Talent:
- Usuario 1: RepresentativeTalent, repres1234
- Usuario 2: antonioR, antonio1234

Las credenciales que no han sido proporcionadas, o bien son privadas, o bien no existen. Para iniciar sesión en IT Talent, debe crearse una cuenta siguiendo el formulario de registro explicado en el manual.

1.2 Changelog#

Los cambios en la aplicación realizados durante el tiempo de esta entrega son los siguientes:

Nueva funcionalidad en el inicio de sesión para cambiar de contraseña en caso de haberla olvidado.
Cambios en la visualización de búsquedas y análisis.
Bug fixing.

2. Manual de Usuario de candidato

A continuación se describen los pasos necesarios para probar los casos de uso core de IT Talent como usuario candidato.

2.1 Registro#

Si es nuevo en IT Talent, deberá crearse una cuenta que se corresponda con el rol de la aplicación que desea utilizar. Para ello, primero acceda a la página de inicio y haga clic en el botón “Register”.

Una vez dentro, seleccione el rol que desea utilizar (candidato o representante). En el caso de este manual, seleccionaremos “Candidate”.

A continuación, rellene los campos del formulario, especialmente aquellos marcados con un asterisco, ya que son obligatorios. Si un campo se introduce incorrectamente, debería aparecer un breve mensaje de error justo debajo del campo introducido. Asegúrese de introducir información real y útil para usted, o de otra forma, no aprovechará las funcionalidades de la aplicación. El número de teléfono debe tener un formato válido (ej.: “+34 -612123123”). El correo electrónico ha de ser real o, de lo contrario, la API de validación de correo no permitirá registrar al usuario. Cabe destacar que la API de validación de correo tiene un límite de 50 validaciones diarias y al alcanzar ese límite no se validará el correo.

Acepte las condiciones de privacidad y haga clic en el botón de registro al final del formulario. Si todo ha salido correctamente, debería ver un modal indicando que el proceso puede tardar un tiempo y debería redirigirle al perfil correspondiente a su rol seleccionado. El registro debería funcionar correctamente e iniciar la sesión.

2.2 Inicio de sesión#

Una vez se tiene una cuenta creada en IT Talent, se puede acceder de forma sencilla accediendo a la página de inicio y haciendo clic en el botón “Login”.

Ahora debe introducir su nombre de usuario previamente establecido para poder identificarle y su contraseña para la autenticación. Haga clic en el botón de inicio de sesión al final del formulario y debería redirigirle a su perfil de forma correcta.

Si ha olvidado su contraseña, puede hacer clic en el enlace con el texto “Forgot your password?” y accederá a un formulario donde se le pedirá un usuario o correo electrónico. Se le enviará por correo la información pertinente para cambiar su contraseña.

Si la sesión lleva demasiado tiempo iniciada, se cerrará automáticamente y un mensaje de error aparecerá en pantalla, redirigiéndole a la pantalla de Login.

2.3 Cierre de sesión#

Al iniciar sesión podrá ver en el menú lateral accesible mediante el botón desplegable a la izquierda de la página, que aparece un pequeño marco con su información principal de sesión. Ahí puede hacer clic en el botón de logout y se cerrará la sesión.

Una vez cerrada la sesión la aplicación le debería redirigir a la página principal y debería ver que la sesión está efectivamente terminada.

2.4 Perfil#

Abriendo la barra de navegación en el botón desplegable en forma de flecha (a la izquierda de la página), debería ser capaz de acceder al perfil de usuario en la parte inferior del menú lateral. La barra de navegación debería verse tal y como se muestra en la imagen.

Una vez se ha accedido al perfil, debería ver una imagen por defecto y unos datos de usuario. Dichos datos deben corresponderse con los introducidos en el momento de crear la cuenta.

2.5 Editar perfil#

Debe aparecer en su perfil un botón de edición “Update”.

Una vez accedido a la página de actualización del perfil, debería ver varios campos modificables, así como un campo para introducir un enlace a una imagen. Una vez modificado el perfil, se puede hacer clic en “Update” para confirmar los cambios.

También es posible modificar la contraseña del usuario haciendo clic en el botón “Change Password”. Debe confirmar su contraseña antigua y luego introducir una nueva para ello. La URL de la foto de perfil debe acabar en .png o .jpg, como esta: https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Linear\_regression.svg/1280px-Linear\_regression.svg.png

Además, podrá actualizar su análisis de Github almacenado en la aplicación para que los representantes puedan ver sus datos más recientes. Opcionalmente, puede introducir un token privado de Github con permisos de lectura. Con el token privado, podrá incluir en su análisis sus datos protegidos y ampliar el alcance del análisis.

2.6 Developer Info#

Una de las funcionalidades clave de IT Talent es la realización de análisis de usuarios a través de credenciales de Github. Los usuarios representantes podrán acceder a una funcionalidad de análisis de datos de usuario que permite analizar a un candidato que haya ofrecido sus datos, incluso si este no está registrado en la aplicación. Los candidatos podrán acceder a su información de análisis desde su perfil.

2.7 Mi análisis#

A través de la barra de navegación accesible mediante el botón desplegable a la izquierda de la pantalla, se puede acceder a su perfil. Desde ahí, verá una sección “Developer Info”.

Cada vez que un candidato se registra en la aplicación con un usuario de Github, la aplicación genera un análisis de su información pública. La página de Developer Info ofrece numerosa información acerca del usuario. Se incluyen desde el número de commits hasta los lenguajes más utilizados, pasando por los repositorios públicos más importantes. Esta información es la misma que los usuarios representantes pueden ver al analizar a un usuario, solo que si está registrado, podrá aparecer en los resultados de las búsquedas de equipo que realizan los representantes.

2.8 Work Experience#

Al igual que la información de desarrollador (Developer Info), también existe en su perfil una sección al final de la página que muestra su experiencia laboral o “Work Experience”.

2.9 Añadir experiencia laboral#

Desde la página del perfil, acceda al apartado de experiencia laboral y haga clic en el botón de “Create new work experience”.

Debería poder ver ahora un formulario con varios campos a rellenar. Debe poder seleccionar con un selector de calendario una fecha de inicio y una fecha de fin, que debe ser posterior. Introduzca también el nombre del proyecto y el área y haga clic en “Create”.

2.10 Gestionar experiencia laboral#

Una vez creada, debería poder ver en su apartado de experiencia laboral una nueva entrada con los datos introducidos en el formulario.

Haciendo clic en el nombre, podrá ver una página con la información ampliada de su experiencia laboral. En todo momento podrá editar (a través del botón “Update”) o borrar la entrada (a través del botón “Delete”).

2.11 Notificaciones#

Si desea ver qué representantes han visitado su análisis, puede acceder a la página de notificaciones, donde aparecerán todas las visitas de su análisis registradas. Para acceder puede hacer clic en el icono en forma de sobre en el menú lateral accesible mediante el botón deslizante a la izquierda de la pantalla. Este sobre contendrá además un icono con el número de notificaciones pendientes.

Debería entonces ver una lista de las notificaciones de los representantes que han visitado su perfil ordenadas por fecha y sin repetir. Si ha adquirido el plan Pro, podrá ver en las nuevas notificaciones que reciba qué empresa ha sido la que ha visitado su perfil. Si quiere probar a analizar su perfil, puede iniciar sesión como representante (nombre: RepresentativeTalent y contraseña: repres1234), pero por favor no elimine la cuenta ni modifique ninguno de los datos. Para realizar un análisis vaya a la pestaña “My Analysis” e inserte el nombre de Github que puso en su cuenta.

2.12 Perfil del representante#

Si tiene el plan Pro adquirido (más información en el apartado de suscripciones), podrá hacer clic en un botón “View profile” y podrá acceder al perfil del representante que ha visitado su análisis.

En el perfil del representante podrá ver datos como el nombre de la empresa o sus datos de contacto.

2.13 Gestionar notificaciones#

El botón “Dismiss” de las notificaciones permite eliminarlas y dejar de visualizarlas en pantalla.

2.14 Suscripción#

En IT Talent, un usuario, ya sea candidato o representante, puede acceder a una serie de ventajas distintas en función del plan que decida obtener. Ambos tipos de usuario tienen planes diferentes, cada uno con sus ventajas únicas.

2.15 Planes del usuario candidato#

El usuario candidato puede acceder a dos planes distintos: básico y avanzado.

Plan básico. Contiene todas las funcionalidades básicas de IT Talent, como la gestión de la cuenta, análisis propio, datos de desarrollador, etc.
Plan avanzado. Permite actualizar el perfil más a menudo, acceder a estadísticas globales de la aplicación, entre otros.

2.16 Selección de plan#

Accede a través de la barra de navegación (a través del botón desplegable de la izquierda de la pantalla) a la página de “Subscription”.

Una vez dentro debería poder ver una página de selección de plan con los planes correspondientes a su rol. Puede ver las características de cada uno de los planes así como cuál es el plan más popular entre los usuarios en la aplicación.

Haga clic en “Subscribe” y podrá acceder a la página de compra. Dentro introduzca sus credenciales de pago y haga clic en “Purchase” para cambiar su plan. *Es muy importante que NO utilice datos reales, en su lugar utilice las tarjetas de test de Stripe, como por ejemplo el número 4242 4242 4242 4242 (el CVV y fecha pueden ser aleatorios). Si utiliza datos reales, podrán ser vistos desde la página de Stripe, tenga cuidado.*

2.17 Tendencias#

Si forma parte del plan pro de candidatos, podrá acceder a la página de tendencias, donde se mostrarán estadísticas globales de interés para los candidatos.

2.18 Estadísticas#

La página de “Trends” accesible a través del menú lateral desplegable, ofrece una vista general sobre las estadísticas de todos los usuarios de la aplicación.

Esta página recopila datos de todos los análisis y búsquedas realizadas por representantes, de modo que facilita al candidato cierta información sobre cuáles son las tendencias de búsqueda que las empresas y de las tecnologías más comunes entre los otros desarrolladores.

Podrá ver múltiples gráficas mostrando datos visualmente tanto de las tecnologías más utilizadas por los desarrolladores, como de las más solicitadas por los representantes en sus búsquedas de equipo. Podrá mantener el ratón encima de las gráficas para obtener datos numéricos de las estadísticas.

2.19 Información#

IT Talent incluye páginas sencillas que todos los usuarios deben poder ver en cualquier momento sin problema.

Para acceder, despliegue la barra de navegación con el botón a la izquierda de la pantalla y verá un enlace a la página de “Information”.

Dentro de la página, debe poder verse un resumen de la información de soporte. Además, incluye una pequeña sección con preguntas frecuentes.

3. Manual de Usuario de representantes

A continuación se describen los pasos necesarios para probar los casos de uso core de IT Talent como usuario representante.

3.1 Registro#

Una vez dentro, seleccione el rol que desea utilizar (candidato o representante). En el caso de este manual, seleccionaremos “Representative”.

Acepte las condiciones de privacidad y haga clic en el botón de registro al final del formulario. Si todo ha salido correctamente, debería redirigirle al perfil correspondiente a su rol seleccionado. El registro debería funcionar correctamente e iniciar la sesión.

Una vez registrado, no podrá utilizar la aplicación hasta que elija uno de los planes de suscripción. Haga clic en “Subscribe”, introduzca sus credenciales de pago (*NO utilice datos reales, en su lugar puede usar el número “4242 4242 4242 4242”*) y haga clic en “Purchase”. Más información con respecto a las suscripciones en el apartado de suscripciones de este manual.

3.2 Inicio de sesión#

Una vez se tiene una cuenta creada en IT Talent, se puede acceder de forma sencilla accediendo a la página de inicio y haciendo clic en el botón “Login”.

Si la sesión lleva demasiado tiempo iniciada, se cerrará automáticamente y un mensaje aparecerá en pantalla.

3.3 Cierre de sesión#

Una vez cerrada la sesión la aplicación le debería redirigir a la página principal y debería ver que la sesión está efectivamente terminada.

3.4 Perfil#

Abriendo la barra de navegación en el botón desplegable en forma de flecha (a la izquierda de la página), debería ser capaz de acceder al perfil de usuario. La barra de navegación debería verse tal y como se muestra en la imagen.

Una vez se ha accedido al perfil, debería ver una imagen por defecto y unos datos de usuario. Dichos datos deben corresponder con los introducidos en el momento de crear la cuenta.

3.5 Editar perfil#

Debe aparecer en su perfil un botón de edición “Update”.

3.6 Últimas acciones#

El perfil tiene además un resumen del historial de búsquedas y de análisis. Puede hacer clic en “See All” para acceder al historial completo o hacer clic sobre una de las entradas para acceder a la página concreta de ese análisis o búsqueda.

3.7 Análisis#

3.8 Análisis#

A través de la barra de navegación accesible mediante el botón desplegable a la izquierda de la pantalla, se puede acceder a la sección “My Analysis”.

Verá una página con un pequeño formulario. Introduzca el nombre de usuario de la cuenta de Github de aquel desarrollador a quien desee analizar. Si fuera necesario, de forma consensuada y externa a la aplicación, obtenga el token de Github de este desarrollador para poder analizar sus datos privados. El token debería tener, al menos, los permisos de lectura de Github para poder obtener todos los datos tanto públicos como privados. Es importante saber que cada análisis se almacena en la base de datos de la aplicación (a menos que ya existiera).

La página ofrece numerosa información acerca del usuario de Github, aunque en un futuro es posible que permita mostrar más datos. Se incluyen desde el número de commits hasta los lenguajes utilizados. Si así lo desea, puede añadir a favoritos dicho análisis para visualizarlos más fácilmente en su historial.

Podrá ver varias secciones dentro del análisis. La sección “Top recent Repositories” muestra los repositorios recientes más populares de dicho usuario. Por otro lado, la sección “Experience” muestra datos sobre las tecnologías y trabajos de dicho perfil.

3.9 Historial de análisis#

Para acceder a su historial de análisis, vaya a la barra de navegación (accesible a través del botón desplegable de la izquierda de la pantalla) y haga clic en “My Analysis”.

Una vez dentro, haga clic en “Analysis List” (también puede acceder al historial completo desde su perfil).

Dentro de la lista de análisis podrá ver una lista de todos sus análisis con el nombre del usuario analizado, la fecha, así como unos botones de borrar o añadir a favoritos. Si hace clic en cualquiera de los análisis que aparecen en la lista, podrá acceder directamente a la información correspondiente sin necesidad de volver a analizar al usuario.

Puede filtrar las entradas del historial según si están o no marcadas como favoritos. Para ello haga clic en el desplegable “Choose a filter” y seleccione uno de los tres filtros disponibles.

Para borrar una entrada del historial, simplemente haga clic en el icono de un cubo de basura al lado de la entrada que desea eliminar. Debería aparecer una ventana pidiendo confirmación y, una vez aceptada, la eliminación de la entrada debería llevarse a cabo. Esto no eliminará el análisis de la base de datos, sino que eliminará el historial en su cuenta.

Para permitir que el usuario pueda cancelar la acción de añadir a favoritos sin problema, la página no debería actualizarse automáticamente cuando se hace clic sobre el botón de añadir a favoritos.

3.10 Búsqueda#

Una de las funcionalidades más interesantes de IT Talent es la búsqueda. Permite a los usuarios representantes seleccionar requisitos y obtener un equipo completo de los candidatos con mejor compatibilidad.

3.11 Realizar una búsqueda#

Para acceder a la página de búsqueda, haga clic en “Team Search” en el menú lateral accesible a la izquierda de la página.

Una vez en la página, puede hacer clic en “New Search” para comenzar la búsqueda. Una vez en el formulario de búsqueda, verá arriba un desplegable que le permitirá escoger cuántos usuarios se desea buscar para su equipo. En un futuro, se ampliará el número de usuarios a buscar y, dependiendo del plan elegido, deberá poder elegir un número de usuarios diferente.

Por cada uno de los miembros del equipo puede elegir varios lenguajes, tecnologías y campos de trabajo, además de un número mínimo de años de experiencia. Una vez haya elegido los miembros que está buscando, puede acceder a la búsqueda mediante el botón “Search”.

Una vez terminada la búsqueda, verá que aparecen varios desplegables. Cada uno de ellos se corresponde con un resultado de la búsqueda, es decir, un miembro del equipo que encaje aproximadamente con los filtros establecidos. Habiendo pocos datos, es normal que los resultados no sean siempre satisfactorios.

Si abre uno de los desplegables, podrá ver los filtros utilizados, así como el nombre de los posibles candidatos y otros datos, así como el enlace a su análisis personal.

3.12 Historial de búsquedas#

Cuando realice alguna búsqueda, es posible que le interese revisitarla en algún momento. Es por ello que existe una sección de historial de búsquedas de equipo. Para acceder, dentro de la ventana de búsqueda (o desde su perfil) haga clic en “Search List”.

Al igual que en el historial de análisis, podrá eliminar entradas del historial, así como marcarlas como favoritos y revisitarlas.

3.13 Suscripción#

3.14 Planes del usuario representante#

El usuario representante puede acceder a tres planes distintos: básico, avanzado y personalizado.

Plan básico. Contiene todas las funcionalidades básicas de IT Talent, como la gestión de la cuenta, análisis de candidatos, búsqueda, historial, etc.
Plan avanzado. Permite realizar más peticiones de análisis y búsqueda, realizar búsquedas de equipos más grandes y más.
Plan personalizado. Permite contactar con el equipo de IT Talent para acordar un plan que se ajuste a sus necesidades.

3.15 Selección de plan#

Accede a través de la barra de navegación (a través del botón desplegable de la izquierda de la pantalla) a la página de “Subscription”.

3.16 Información#

IT Talent incluye páginas sencillas que todos los usuarios deben poder ver en cualquier momento sin problema.

Para acceder, despliegue la barra de navegación con el botón a la izquierda de la pantalla y verá un enlace a la página de “Information”.

Dentro de la página, debe poder verse un resumen de la información de soporte. Además, incluye una pequeña sección con preguntas frecuentes.